﻿# Welcome to Orchard Book

This Website is different in the way each page is based on a static file, and those files
can be written using [Markdown](http://daringfireball.net/projects/markdown/)

## Special features

### Resolving urls

Any url beginning with `~/` will be resolved based on the host name, using standard ASP.NET convention.

Example: 
`[Orchard Book](~/OrchardBook/)`

### Server-side comments

Markdown doesn't have the notion of server-side comments. You can write HTML comments but they will be 
rendered on client, eventhough not displayed. Using this website you can write server-side comments though
by using `//` a the beginning of a line

Example: `// this is a comment`

### Server-side includes

This features lets you create pages based on several external files. This can be used to reuse the same
Markdown files, or to simply separate some elements physicalle, like chapters or articles.

Example: `@include(~/OrchardBook/Message.markdown)`

> If the included content is in Markdown, it will also be processed.